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l.o  INTRODUCTION 


1 .1  Requirements 

This  document  is  the  description  of  the  design  changes  for  the  PLANI” 
system  enhancements  as  provided  for  in  Phase  3  of  the  contract  with 
the  U.  S.  Army  Research  Institute  for  *he  Behavioral  and  Social  Sciences 
No.  U AKCl 9-7*-C-001 h .  "his  document  replaces  the  proposed  document  dated 
IS  October,  1<?74  which  presented  alternative  approaches.  The  details 
of  the  alternative  approaches  have  been  deleted  from  the  current  document. 

1 .2  Scone 

rhis  document  presents  the  design  changes  to  allov  a  PLANXT  lesson  to 
control  ACC/CCC,  VFMED  and  VIPD  terminals  so  that  TACFIRE/TOS2  systems 
operations  can  be  simulated  under  FLANT".  "he  complete  terminal  control 
which  will  be  provided  to  a  lesson  will  include  the  followings 

1.  Capability  to  yk&fie  the  full  7-line  and/or  lb-line  display 

A  ' 

editor  (DS)  screen  sizes  or  all  supported  terminal  types. 

2.  Capability  to  utilise  both  the  RI>  and  C/E  V  screens  of  the 

A 

ACC/OCC. 

U 

3.  Capability  +o  control  and  utilize  all  of  the  ACC/OCC,  VFMED 
and  MIOD  terminal  switches ,  indicators,  display  formats  and 
modes  of  operation. 

1.3  Ground  Rules  and  Assumption? 

The  ^ollowin?  convent  ions  and  definitions  apply  to  this  documents 

1.  The  methods  and  commands  described  for  the  ACC  apply  equally 
to  the  CCC  terminal  in  the  simulation  e*  "032  CCC  operation. 

2.  "NORMAL  WDF."  -  The  normal  mode  of  a  FLANI"  terminal. 

3.  "CONTROL  MODE''  -  The  mode  of  the  terminal  in  which  an 
author's  lesson  has  complete  control  of  the  terminal. 
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The  methods  and  commands  described  in  this  document,  are  designed  to  allow 
existing  lessons  to  run  in  the  "NORMAL  MODE"  without  modification  to 
those  lessons.  New  lessons  prepared  using  the  methods  and  commands 
described  herein  may  make  full  use  of  the  "NORMAL  MODE"  and  the 
"CONTROL  MODE"  to  provide  instruction  as  well  as  simulation  of  ACC  and 
VFMED  operation  under  the  TACFIRE  Field  Operating  System. 

The  methods  and  commands  described  herein  apply  to  PLANT?  2.8  and  above 
and  do  not  require  any  modifications  to  the  PLANIT  programs. 

1 Reference  Documents 

PLANIT  LANGUAGE  EXTENSIONS  THROUGH  VERSION  2.8 
(Charles  H.  Frye:  March  9,  197^) 

PLANIT  SUPPORT  PROGRAMS  OPERATOR/USER  MANUAL 
(Litton  Document  No.  125200-900,  Change  1) 

1.5  Document  Organisation 

This  document  has  been  organised  with  separate  appendices  for  the  author 
apparent  commands  and  responses,  so  that  they  could  be  used  as  the  basis 
for  the  preparation  of  author  reference  material.  The  information 
described  in  each  section  is  briefly  summarised  belowt 

a.  Section  1 »  This  section  provides  general  and  background 
information  related  to  the  PLANIT  System  Enhancements. 

b.  Section  2 »  Discusses  miscellaneous  changes  to  the  system 
which  are  not  directly  related  to  t.he  full  terminal  control 
features. 

e.  Section  Si  Discusses  the  method  of  full  terminal  control  and 
the  PLANIT,  lessen  and  MIOP  interface. 


d.  Section  ^ t  Discusses  items  which  the  author  must  take  into 
account, 

e.  Section  5 »  Discusses  system  errors  and  other  operator  terminal 
procedures ,  while  Terminal  *4.  is  be  ins  used  in  "CONTROL  MODE" 
for  a  lesson. 

f.  Section  6:  Provides  a  eeneral  description  of  the 

programming  task  involved. 

K.  Appendix  A;  Presents  the  full  terminal  control  commands 
and  methods  including  sample  lessons. 

h.  Appendix  Bi  Discusses  the  use  of  the  message  address  preamble 
for  the  control  of  VEXED  and  XIOD  terminals. 
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2.0  REQUIRED  CHANGES  TO  THE  SYSTEM 

The  changes  discussed  in  the  following  subparagraphs  are  system 
changes  not  directly  related  to  full  control  of  the  terminals. 

They  affect  the  VFMED/MlOD  operation  and  the  allocation  of 
terminal  input/outr.t  buJ'ers. 

2.1  VFMED/talOC  Answer  Preamble 

The  current  VFMED/'IIOD  user  procedures  to  send  an  answer  to  PLANIT 

calls  for  entering  a  5-character  preamble  "J0000”  before  entering 

up  to  a  67-character  answer.  The  5-character  preamble  is  inconsistent 

2 

with  TACFIRE  and  TOS“  procedures  (see  Appendix  B  >, 

The  User  Manual  and  System  Support  Software  will  be  modified  to  use 
a  6-character  message  address  preamble  "J00000".  In  either  the 
"NORMAL  MODE"  or  the  "CONTROL  MODE"  the  1st  and  6th  characters 
(destination  and  source)  characters  will  be  verified  and  if  incorrect 
will  cause  an  error.  The  other  characters  will  not  be  verified.  This 
format  will  be  consistant  with  messages  from  the  computer  (currently 
a  6-character  preamble  is  generated).  This  format  will  also  accept 

message  address  preambles  that  would  normally  be  omposed  in  a  TACFIRE 

~> 

or  TOS  environment  This  format  allows  for  a  maximum  answer  length  of 
66  characters  In  the  "NORMAL  MODE". 

2.2  Terminal  Buffer  Allocation 

The  current  PLANIT  support  software  uses  an  84-character  input  buffer 
and  a  1024-character  output  buffer  for  each  terminal.  This  scheme  and 
the  I/O  software  associated  with  it  has  the  following  disadvantages: 
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The  input  buffer  size  to  accommodate  the  full  screen 
read  capability  would  have  to  be  increased  from 
84  characters  to  1036  characters. 


2.  An  input  received  from  a  VFMED  or  MIOD  terminal  of  more 
than  84  characters  results  in  a  terminal  error.  This 
commonly  occurs  when  the  EOT  character  following  the 
answer  is  omitted. 

The  system  support  software  will  be  modified  to  use  a  common 
input /output  buffer  of  1048  characters  as  shewn  in  Figure  1. 


Start  of  input 
buffer  area  — * 


Start  of  output 
buffer  area 


12  characters 


1036  characters 


Space  for  VFMED/SlIOD 
9-character  generated 
messages : 

Auto-Ack 
Manual -Ack 
Manual-Nak 
Message-Request 


FIGURE  1.  New  Terminal  Buffer  Allocation 


The  advantages  of  the  new  scheme  are  as  follows : 

1.  Fewer  total  buffer  characters  are  required. 

2.  A  full  screen  read  from  the  terminals  is  accommodated. 

3.  Answers  from  a  VFMED  or  MIOD  terminal  longer  than 

84  characters  will  not  cause  an  error.  An  automatic 
EOT  is  generated  after  the  last  character  of  the 
last  line  of  the  display. 
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4.  The  first  12  characters  of  the  common  buffer  are  used 
to  receive  Auto-Ack,  Manual-Ack,  Manual-Nak  (RE-XMIT) 
and  Message-Request  messages  and  will  not  affect  the 
output  message  area,  so  that  a  RE-XMTT  request  can  be 
processed. 

The  allowed  receive  buffer  length  will  be  controlled  for  a  VFMED 
or  MIOD  terminal  to  prevent  the  user  from  inadvertently  transmitting 
a  full  screen  message  at  the  wrong  time  which  would  destroy  the  output 
buffer  data.  The  allowed  receiver  buffer  length  will  be  as  follows: 

1.  Normal Ly  the  receive  buffer  length  will  be  set  to  12 
characters  to  accommodate  any  9-character  terminal 

operated  messages.  Longer  messages  will  be  ignored. 

2.  Tlie  receive  buffer  length  will  be  increased  to  103b 
characters  (a  full  screen  read)  only  after  the  output 
buffer  has  boon  transmitted  in  the  terminal  and 

PI. AMT  has  a  read  requesi  ael  ive. 

.  .5  New  VFMED  NO-ACK  ’'lode 

The  support  software  will  be  modi  fil'd  to  allow  the  selection  of  a 
NO-ACK  mode  of  operation  taking  full  advantage  of  the  new  VFMED. 

When  selected,  PLAN IT  text  will  be  printed  on  the  ELP  wi thout  requiring 
the  student  to  take  any  switch  a>  t  ions.  The  student  will  read  PLAN1T 
text  only  from  the  ELP  ami  use  the  C/E  display  only  to  compose  answers. 
The  use  of  the  ACK  switch  in  the  NO-ACK  mode  is  not  required  and  will 
be  ignored  if  pressed.  Pressing  the  RE-XMIT  switch  will  still  cause 
retransmi s^ion  of  i ho  last  7  (or  14)  lines.  After  printing  the  last 
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line  of  a  PLANIT  message,  the  ELP  will  be  advanced  13  lines  so  that 
the  last  line  will  be  visible  to  the  operator  on  the  new  ELP. 

The  above  processing  is  valid  only  for  the  "NORMAL  MODE"  of  the 
terminal  with  a  typical  lesson.  When  a  lesson  enters  the  "CONTROL  MODE" 
the  lesson  will  control  the  interaction. 

The  NO-ACK  mode  will  also  function  with  the  old  VFMED,  however  the  print 
out  is  not  convenient  to  read. 

It  will  be  feasible  to  concurrently  select  the  14-LINE  and  NO-ACK  modes 
realizing  that  printer  outputs  will  be  14  line  (or  less)  groups  and 
that  answers  will  be  limited  to  1-line  ("NORMAL  MODE")  or  7-lines 
("CONTROL  MODE").  If  the  switch  inside  the  new  VFMED  Display  Editor 
is  set  to  14  lines,  the  "CONTROL  MODE"  answer  would  be  the  full  14-line 
capability. 
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*3.0  ^FTHOD  OF  I'*FLSV2NT ATICN 

Tvo  methods  of  imclemen*at  ion  of  the  full  terminal  control  features  were 
originally  considered.  The  first  was  a  mnemonic  accroach  where  mnemonic 
commands  were  imbeded  in  ♦he  lesson  text  and  mnemonic  answers  were  resumed 
to  FLANI”  indicating  svi+eh  ae+ions.  The  second  was  a  SPECIAL  function 
call  accroach  where  commands  and  switch  actions  were  cassed  as  numeric 
o8rame+ers.  The  current  accroach  utilis'es  a  combination  of  the  two 
original  accroaches  and  is  described  in  Aocendix  A. 


Table  “M  shows  the  rLANIT  C0*WK  items  which  will  be  referenced  by 
YICF  'or  full  terminal  control. 

Cn«  item,  no*  covered  elsewhere,  is  *he  method  which  YTOP  will  use  *o 
lor  of'  the  terminal  (and  l®sson)  in  the  even*  of  a  mnemonic  command 
error.  This  will  be  done  by  returning  a  -t  status  'or  the  terminal  vrite 
request . 


VI 


TABLE  3-1.  XIOP  REFERENCED  PLANT!  COMMON  ITEMS 


ITEM  NAVR  &  DECLARATION 

■—  -  ■  "  ■  -  ■  ■  ■  ■ 

VALUES 

ICBMOM 

BIN  FIXED 

Currant  channel  (terminal)  number. 

1.  2,  3  ... 

MODES 

BIN  FIXED 

1  -  command  mode 

2  -  identify  yourself 

3  -  lesson 
b  -  system 

5  -  debue  mode 

NCALC 

BIN  FIXED 

0  -  not  in  CALC  mode 

1  -  in  CALC  mode 

NAMES  (W?0) 

BIN  FIXED 

NAMES(NTWP20)  and  NAwES(NTMP20  +  1) 
contain  the  lesson  name  being:  read 

NTMP20 

BIN  FIXED 

from  or  written  on  taoe  by  PLANIT . 

The  lesson  name  is  used  by  MIOP  for 
multi-lesson  tape  reels. 

U. o  AUTHOR  CONSIDERATIONS 

Log-On  in  the  Middle  ef  a  "CONTROL  VCDE"  Lesson 
Because  of  the  possibility  of  logging  on  in  the  middle  of  *  lesson,  the 
author  must  carefully  establish  re-entry  Doints  vithin  the  lesson.  This 
is  done  by  placing  a  period  after  the  frame  type,  e.g. ,  FRAME  3t00  (Q.). 
The  terminal  will  always  be  in  the  "NORMAL  MODE"  when  a  lesson 
is  entered  or  re-entered. 

U,2  Physical  Terminal  ID 

The  use  of  the  SPECIAL  call  to  the  terminal  requires  one  ot  *he  variables 
to  be  ♦he  physical  terminal  number.  It  is  recommended  that  "TERMINAL", 
a  new  CALC  item  name,  be  used  in  the  SPECIAL  call  directly  such  ass 
FUNCTION  CMODE  s  SPECIAL(l ,1 .TERMINAL, I, C,X ,Y,Z ,0,0) 

Section  5.h  0f  "PLANIT  LANGUAGE  EXTENSIONS  "rHR0UGH  VERSION  2.P"  describes 
the  new  CALC  item  TERMINAL. 

The  first  three  variables  (l ,1 (TERMINAL)  could  easily  have  been  eliminated 
from  the  call,  but  allow  for  possible  future  expansion.  The  call 
(1,2, A,...)  could,  for  instance,  be  implemented  *o  allow  a  monitor  lesson 
to  obtain  t.he  status  of  another  terminal  in  the  system. 
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5,0  SYSTEM  ERRORS  AND  SYSTEM  OPERATOR  ACTIONS 

The  possibility  exists  that  terminal  *1,  the  only  ACC  at  this  time, 
being  used  for  a  "CONTROL  MODE"  lesson,  might  also  be  required  for 
a  System  Operator  function  at  the  same  time.  The  following  paragraphs 
describe  the  problems. 

5.1  Error  Messaoc- 

The  RD  screen  of  terminal  *1  has  been  used  to  report  errors  on  various 

device*-.  Although  an  operator  may  have  become  dependent  on  these 

indications,  the  user  manual  points  out  that  the  messages  are 

informational  and  that  PLANIT,  ST.ART  or  FINAL  will  put  out  specific 

messages  requesting  action,  should  any  be  required.  Therefore, 
c 

the  absence  of  the  error  report  on  the  RD  screen  when  in  the 
"CONTROL  MODE"  should  not  seriously  affect  the  system. 

5.2  System  Operator  Messages 

While  in  the  "CONTROL  MODE"  there  are  two  types  of  operator  messages: 

1 .  Those  from  MlOP,  for  instance,  a  terminal  *2  TAPE  MOUNT 
REQUEST . 

2.  Those  from  PLANIT,  for  instance,  a  DIAL  message  from  another 
termi nal . 

In  the  first  case,  a  MIOP  message,  separate  buffer*-  are  used  and  the 
lesson  status,  etc.,  is  saved.-  In  the  second  case,  a  PLANIT  message, 
the  message  may  be  lost,  put  on  the  wrong  screen  and  may  have  an 
adverse  affect  on  the  lesson.  Those  situations  require  further 
invest i gation/di scussion . 
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6,0  PROGRAMMING  TASK 

The  following  sub-paragraphs  describe  the  general  programming  tasks 
involved  in  the  implementation  of  the  system  enhancements  described 
in  this  document. 

6.1  COMPOOL  Changes 

The  changes  to  the  COMPOOL  (the  common  data  pool  available  to  all 
support  programs)  are  minor.  The  terminal  buffer  allocations  will  be 
involved  and  some  changes/additions  to  flag  bits  and  status  words. 

6.2  POS  Chanoes 

Changes  to  POS  are  required  for  the  following: 

1.  Returning  full  ACC  statu*  to  TMIOP. 

2C  Controlling  VFMED/tylOP  read  buffer  length  per  TMIOP  direction. 

3.  Passing  received  message*  \oxcept  Auto-Acks)  to  TMIOP  processing. 

6.3  TMIOP  Chanoes 

The  changes  to  TMIOP  are  extensive  and  encompass  the  following: 

1.  Absorbtion  of  some  original  POS  functions  related  to  the 
terminaxs  (ACC  status  and  terminal  received  message  processing). 

2.  Decoding  the  "CONTROL  MODE"  commands. 

3.  Providing  the  correct  responses  to  PLANIT  when  in  the  "CONTROL 
MODE" . 

6.U  MIOP  Chanoes 

The  changes  to  MIOP  will  be  minimal,  primarily  passing  the  SPECIAL 
call  onto  TMIOP  for  processing. 
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6.5  Additional  POS  Changes 

The  following  capabilities  will  be  added  to  POS  to  facilitate  remote 
terminal  mode,  device  and  channel  assignment t 

1.  The  ability  to  select  7  or  Inline  mode  for  each  terminal 
including  the  ACC. 

2.  The  ability  to  assign  each  remote  terminal  as  a  VIOD, 

Old  VFVED  or  New  VTMED. 

3.  The  ability  to  assign  the  TDT  channel  associated  with 
each  remote  terminal  or  turn  that  terminal  off. 

U,  The  ability  to  turn  on  the  NO-ACK  mode  for  an  Old  or  New 
VFMED  terminal. 

6.6  START  Changes 

Start  will  be  modified  to  eliminate  the  "number  of  active 

terminals"  message. 


6-2 


4PPENDIV  A 
'ERKIN AL  CONTROL 


4-1.  o  iN-Ror-unoN 

4-1.1  Purpose  and  Scope 

"he  purpose  of  this  apoendix  is  +o  describe  The  method  by  which  a  PLANT" 
author  may  exercise  complete  control  over  the  ACC/CC",  VE^E?  and  VI0" 
terminals.  The  fellovinr  definitions  apply  to  this  appendix: 

a.  "NORvAL  MCnE"  -  "he  normal  mode  o'  a  PLANT?  terminal. 

b.  "CONTROL  "ICDr"  -  The  mode  of  the  terminal  in  which 

an  author's  lesson  has  complete  control  of  the  terminal. 

The  methods  and  commands  are  designed  to  allow  exis+ine  lessons  to  run  in 
the  "NORMAL  VCDE"  without  modification  to  those  lessons.  New  lessons 
prepared  usine  +he  methods  and  commands  described  herein  may  make  full 
use  of  the  "NCRVAL  MODE"  and/or  the  "CONTROL  MODE"  to  provide  instruction 
as  well  as  simulation  of  ACC/CCC,  VE^ED  and  ^TCD  operation  under  the 
"AC?TRE/"CS?  -ield  Opera* ine  System. 

"he  methods  and  commands  described  herein  apply  to  FLANTT  2,p  and  above 
and  do  not  reouire  anv  modifications  *o  the  PLANI"  prorrams. 

A-l . 2  Reference  Cocuments 

PLANT?  LANGUAGE  EXTENSIONS  THROUGH  VERSION  2.*;  Charles  K.  '‘rye: 
vareh  l®?*. 

A-2.0  TrR«INAL  C0WAND3 

Two  *voes  of  commands  are  used  f©r  a  lesson  *o  obtain  control  of  the 
terminal.  The  SPECIAL  function  call  commands  allow  limited  control 
and  can  cause  the  "CONTROL  VCDE"  to  be  entered.  Vnemonie  commands 
which  provide  more  precise  control  are  use*4  when  in  the  "COJPRCL  MpPE" 
and  are  imbeded  in  the  lesson  *ext. 
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A-2 . 1  SPECIAL  Function  Call  Commands 

The  calc  function  call  SPECIAL  is  used  to  initiate  the  "CONTROL  MOOS", 
select  certain  modes  without  entering  the  "CONTROL  MODE"  and  as  an  alternate 
form  of  the  GET  and  OET-OPF  mnemonic  commands.  The  SPECIAL  call  to  initiate 
the  "CONTROL  MODE"  is  necessary  so  that  the  author  can  print  and  edit  ♦he 
lesson  without  executing  mnemonic  commands.  The  SPECIAL  function  call  is 
described  in  Section  o'  "PLANT?  LANGUAGE  EXTENSIONS  THROUGH  2.8". 

The  specific  SPECIAL  call  commands  implemented  for  terminal  control  are 
described  in  *he  following  paragraphs. 


The  format  of  the  command  is  as  follows i 


SPECIAL(1,1,T,I,C,X,Y,Z,0,0) 


where  the  arguments  in  the  command  are  as  follows* 

T  -  Terminal  number.  The  terminal  number  upon  which  the 
command  will  be  executed. 

I  -  Intended  terminal  type* 

0  -  ACC,  VPVEO  or  *100  fused  with  command  8  only) 

1  -  ACC 

2  -  VEMpTO 
“3  -  VIOD 

C  -  Command  * 

0  -  Set  7-line  mode 

1  -  Set  lk-line  mode 

2  -  Turn  of'  NO-ACK  mode  (V?*ED  only) 

“3  -  Turn  on  NO-ACK  mode  (VFVED  only) 
h  -  Release  "CONTROL  MOCE" 

5  -  Enter  "CONTROL  *0DE" 

A  -  Turn  off  GET  setup  (same  as  mnemonic  GET-OFE) 

7  -  Setup  GET  function  X,Y,Z.  (same  as  mnemonic  GET(M,N,0) 

except  tha*  X,  Y  and  Z  may  be  calc  variables) 

X  -  Beginning  line  number 
Y  -  Beginning  character  number 

Z  -  Number  of  characters  be  considered  for  answer 

8  -  Return  terminal  type  1,  2  or  “3  to  lesson 
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Each  SPECIAL  call  command  will  re*urn  an  integer  status  which  will  be 
either  o'  the  'ollowinr: 


a.  4n  error  s+a+us  (2)  will  be  returned  *o  PLANT?  which  will 
cause  the  lesson  to  terminate.  An  author  will  be  placed  in 
PLANIT  CCWAKH  »'!0?E  which  allows  hi"!  *o  diaenose  and  'ix  the 
condition.  A  student  will  be  loeeed  off.  The  'ollowinp 
conditions  cause  ♦■his  response: 

1)  A  SFECIAL  call  is  received  when  no+  in  lesson  mode. 

2)  A  SPECIAL  call  is  received  when  in  CALC  mode. 

s)  Firs+  two  SPECIAL  call  variables  are  no+  1,1.  1,1  s+ands 

for  terminal  control  call,  s*uden*  lesson,  ""his  allows 
'or  expansion  o'  SPECIAL  call  'une+ions. 

Ai)  T  variable  is  no+  the  same  as  current  active  channel  number. 

S)  I  variable  is  not  the  same  as  actual  terminal  ♦voe  —  except 

C  =  P. 

*)  C  variable  no+  valid  ranee  *hru  P). 

7)  C  *  2  or  S  and  I  not  eoual  4e  2, 

P)  C  =  7  and  no+  in  "CONTROL  MODE" . 

Q)  C  =  7  and  X,  Y  or  7.  variable  not  valid, 

b.  An  integer  value  will  be  returned  to  the  lesson  'or  each 
valid  command  as  'ellows: 

1)  ?or  C  =  P,  the  value  returned  will  be:  1  (ACC),  2  (VPMED) 
or  ?  (vI0D). 

2)  T'or  all  o+her  commands  a  1  (command  accented)  will  be 
returned. 
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A-2 . 2  Mnemonic  Commands 


The  mnemonic  commands  which  control  the  terminal  appear  as  output  text 
in  a  PLANTT  lesson,  for  instance  group  2  or  a  Q  frame.  Commands  are 
identified  by  t  dollar  signs  "$$3"  followed  by  commands  seoarated  by 
spaces  and  ending  with  the  CR-LF  characters  at  the  end  of  that  line; 
for  examples 

CS-V-Hr*?  5A-CLEAR 

Commands  are  executed  as  they  are  scanned,  A  write  to  the  terminal 

occurs,  without  ooerator  intervention,  when  the  screen  buffer  Is  complete. 

Any  illegal  command  will  terminate  the  "CONTROL  VOTE”,  log  off  the 

terminal  (lesson)  and  display  the  following  messages 

CCWAND  ERROR:  OCXXX'Xy.’' 

.$$$  NC^waL  MCCE  RR3U*'EC 
$$$  LESSON  LOGGED  OF* 

XXX...  is  replaced  by  the  unrecognised  command. 

’’able  A-l  show«  the  mnemonic  commands  which  are  applicable  t0  all  terminals 
(ACC/OCC,  VF'-'EC  and  RIOT),  "able  A-2  and  A-”*  show  the  mnemonic  commands 
which  are  applicable  *o  only  the  ACC/CCC.  "able  A-£  shows  the  various 
mode  selections,  their  defaul*  selection  and  how  *hey  are  selected. 

Figure  A-2  shows  a  sample  ACC  lesson  and  Figure  A-3  shows  a  sample  VFVED 
lesson  making  use  of  the  commands  described, 

A-2 . R  V^VET  and  RIOT  Message  Address  Preambles 

"he  "message  address  preamble"  sent  to  a  VFVED  or  vI0T  determines  vhat 
will  happen  at  the  t#yw.inai.  The  preamble  is  the  first  6  characters 
of  the  message  and  its  affect  is  described  in  detail  in  Appendix  S. 


A-3.0  TERMINAL  READ  AND  VRTE  RESPONSES 

"'he  following  paragraphs  describe  the  responses  to  PLANIT  reads  and 
writes  when  the  terminal  is  in  +he  "CONTROL  MODE". 

A-3.1  PLANIT  Read 

The  responses  to  PLANIT  read  commands  allow  the  author  to  read  switch 
actions  taken  by  the  student  and  the  content  of  screen  messages.  The 
first  read  response  is  reserved  for  returning  a  mnemonic  answer  string 
indicating  the  switch  action  taken  by  the  student.  The  first  read  is 
conditioned  by  any  of  the  'ollovine  occurring  before  the  read  is  issued: 

a.  Issuing  a  GET -OFF  mnemonic  command. 

b.  Issuing  a  f-  command  with  a  SPECIAL  function  call. 

(eouivalent  to  GF^-OFF  mnemonic  command) 

e.  Satisfaction  of  a  previous  GET  setuo  with  a  prior  read. 

d.  Any  PLANIT  write  of  data  to  the  terminal.  A  write  of  a 

eomman'1  line  does  not  constitute  data  for  the  terminal.  Such 
line  must  begin  with  $$$*  and  end  with  $. 

The  first  read  may  be  a  timed  read  and  will  only  be  satisfied  when  a 

switch  action  has  been  taken  or  if  selee+ed  the  read  timer  expires. 

The  screen  data  is  stored  when  an  interrupt able  switch  action  is  taken 

and  is  available  to  the  lesson  by  issuing  a  GET  command  (SPECIAL  function 

call  or  mnemonic)  prior  to  a  read.  The  GET  command  followed  by  a  PLANT” 

read  causes  an  immediate  return  of  the  data  stored.  The  stored  date  is 

valid  until  the  next  vrite  of  data  to  the  terminal.  The  processes 

involved  for  the  ACC/OCC  and  VFMED/MIOD  are  discussed  separately  in 

the  following  paragraohs. 

A-3,1.1  ACC/OCC  Read 

?-3ien  the  operator  presses  an  interrupt.able  switch,  the  data  on  the  CE 
screen  is  read  and  saved  for  further  Processing.  If  the  switch  is 
pressed  then  the  data  read  and  saved  is  from  the  cursor  position  to  the  EOT 


,Jith  any  other  interruptable  switch  action,  the  entire  screen  is  saved 
independent  of*  cursor  position.  This  is  a  software  convention  consistent 
with  the  Field  Operating  System ,  The  response  to  the  first  PLANT  read 
depends  or.  operator  action,  '"he  operator  will  either  press  an  interruptable 
switch  causing  a  mnemonic  answer  string  to  be  returned  to  PLANT  or  the 
read  will  time  out  (if  selected  in  +he  lesson).  The  answer  string 
returned  will  be  mnemonics  separated  by  spaces,  ""he  first  mnemonic  will 
be  the  switch  which  caused  the  interrupt  as  listed  in  Table  A-&,  Following 
that  will  be  +he  matrix  selection  mnemonic  followed  by  uo  to  5  message 
address  selections.  The  matrix  and  message  address  selection  mnemonic 
responses  are  listed  in  Table  A-5. 

A  typical 

answer  would  be  as  follows s 
CA  C-3  VA 

Indicates  pressing  the  C/E  D  CMP"?.  ACTION  switch  caused  the 
interruot  and  that  the  matrix  selection  was  C-3  and  that 
JCE55A05  ADDRESS  indicator  A  was  on, 

•he  ti»ed-ou+  read  is  a  special  case  and  when  it  oecurrs  the  CE  screen 
will  be  read  and  saved.  The  timed-out  read  status  will  be  returned  to 
the  lesson.  No  mnemonic  answer  string  indicating  the  lack  of  a  switch 
action  will  be  returned  t.e  the  lesson,  "he  stored  data  is  available 
by  using  the  GST  command  and  reading  the  data  so  that  the  author  could 
cheek  student  progress  in  filling  out  an  answer. 

A-3.1.2  VFVFD/MICS  Read 

The  VFMED  and  MIOT  hardware  differs  rrom  the  ACC  in  that  the  ACC  may  be 
read  at  any  time  by  the  software  while  the  7FVS?  and  MICT  may  only  be 
read  when  the  tej»ninai  operator  presses  a  switch,  "he  first  read  response 
will  be  one  of  the  5  canned  messages  shown  in  Figure  A-l  depending  on  the 
switch  pressed.  Screen  data,  from  the  cursor  position  to  the  first  SC? 


or  end  of  screen,  is  read  and  j'ow''  only  when  the  Y.'/Z~  switch  is  pressed, 
’his  store4  message  is  available  to  +he  lesson  by  using  the  GET  command 


followed  bv  a  PLANT’  rea4.  7n  the  ease  o'"  a  ti">ed-out  read,  •‘■he  *ime-ou* 
status  is  returned  *o  ♦he  lesson  but  no  da* a  is  available  for  the  0r"r 
command , 

A-3.2  PLANT’  -rite 

. 7\ 

.he  PLANT:  write  function  is  normally  straight  forward.  Cata  may  be 
direc*ed  +e  the  ELP,  C/7  ^  screen  or  PC  screen  i**  the  terminal  is  an 
ACC.  lata  sen+  to  a  VPvr^  or  VICT  is  processed  a*  tha*  terminal  depending 
on  *he  message  address  oreamhle  and  the  prior  s+a*us  of  the  terminal 
(cursor  position  and  CCM?CS~  ''C^E  switch  position). 

vessages  sent  to  a  VTKP*"  or  t'ICT  ♦erminal  must  begin  with  a  ^-character 
"eseege  address  preamble,  ’he  first  charae*er  (message  destination  address) 
of  any  message  sen*  to  a  remote  terminal  will  be  cheeked  for  zero.  If  it  is 
not  a  tero,  it  will  be  forced  to  tero,  the  message  tyr>e  will  be  forced  ♦.© 

P  and  the  message  source  charac*er  will  be  forced  +  0  J.  Por  lesson 
generated  data  t.he  author  should  include  the  message  address  preamble  as 
+he  'irs*  part  of  each  message,  ’he  forced  message  provision  is  intended 
to  allow  t'or  non-lesson  generated  messages  such  as  "enter  your  answer"  and 
"numeric  answer  please". 

It  is  also  to  be  noted  that  OP’  reads  addressed  t©  e  blank  substring  will 
cause  PLANT"'  to  output  "enter  your  answer"  and  cancel  the  OPT  command. 

This  in  turn  des+roys  the  s*ored  data  and  causes  a  vai*  for  switch  action 
read  to  be  started.  To  be  on  the  safe  side,  GET  reads  should  invoke  the 
timed  read  op* ion  an*  interpret  time  out  as  a  blank  answer. 
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TABLE  A-l 


COWARD  LIS* 


TOYMANS  DESCRIPTION 


RELEASE  Returns  the  terminal  to  the  "NOR'-AL  «ODE". 

7-LINE  Sets  the  display  buffer  to  process  7  lines  of  text  end 

answers  for  PLANTS. 


INLINE 


ACK 


NAX 


EOT 


GET -CPF 


GET(M,N,C) 


Sets  the  display  buffer  to  process  lh  lines  of  text 
and  answers  for  PLANTS. 

Causes  ACK  character  (X)  to  be  placed  on  screen  at 
the  point  where  the  first  $  of  the  $$$  was  encountered 
or  immediately  following  the  last  ACK  or  NAK  character. 

Causes  NAX  character  ( )  to  be  placed  on  screen  at 
the  point  where  the  first  $  of  the  $$$  was  encountered 
or  immediately  following  the  last  ACK  or  NAK  character. 

Causes  EOT  character  (  di  )  to  be  placed  on  screen  at 
the  point  where  the  first  $  of  the  $$$  was  encountered 
or  immediately  following  the  last  ACK  or  NAK  character. 
Stops  a  write  operation. 

Cancels  a  previously  selected  OFT"  command.  Normally 
a  GET  command  will  be  cancelled  when  it  has  been 
satisfied  by  a  PLANIT  READ. 

Conditions  the  next  read  to  return  up  to  72  characters 
of  the  saved  screen  display.  M,  N  and  C  are  optional 
parameters  which  allow  specification  of  the  following! 

M  -  beginning  line  number  (legal  values  1  thru  7  (HO). 

N  -  beginning  character  number  (legal  values  1  thru  72). 

0  -  Number  of  characters  to  include  (legal  values  1  thru 
72.  Scanning  will  step  at  end  of  line  or  when  the 
specified  characters  have  been  inspected). 

The  default  values  of  the  GET  command  are  1,1,72,  The 
character  string  returned  to  PLANIT  goes  through  the 
normal  trailing  blank  suppression  and  a  correct  character 
count  is  returned  to  PLANIT.  Legal  forms  of  the  GET 
command  are  as  follows! 

GET  GET(2)  GET(3,h)  GET(M,6) 

Any  number  of  PLANIT  reads,  each  proceeded  by  a  GE^  cemsnd 
can  be  addressed  to  the  saved  screen  so  that  any  number 
of  fields  can  be  inspected. 


tabl-  a -2  a::  only  co**'ait  lit 


"o^irr 

S  A- CLP  A?. 

IS- ILEA5 
ED-CLEAE 


ED-i“ET?E 

ELF-  '.srr 


COPY-ON 


COPY-CEF 


PS3C5.TP’T  ION _ _ 

Cleer  the  SA  panel  status  register  and  *um  off  all 
5 A  panel  indicators. 

Clear  *h*  CS  screen. 

Tear  the  ED  screen. 

This  is  the  default  selection.  Designates  that  the 
'“cl lowing  PLANT"  text  i*  +  o  be  writ+en  on  +he  C5"  screen 
when  co’rlete.  '“o*,Dlet  ion  is  defined  as  any  of  the 
following  conditions: 

a.  9  or  line  buffer  '“ull .  rrcess  will  be 
ignored . 

b.  Command  string  identifier  (???)  encountered. 

EOT,  ACK  and  NAK  eorwands  will  be  processed 
before  *he  write  is  activated. 

c.  A  PLANI~  PE AD  has  been  activated, 

“■estmates  that  the  followine  PLANT!  ter+  is  to  be 
wri+t-n  on  the  ED  screen  when  cosiple+e. 

Decimates  that  the  following  PLANIP  text  is  to  be 
written  on  +he  rLF  onlv  when  eonole+e. 

"his  is  the  default  selection.  Outcu+  which  is  directed 
to  either  screen  is  also  Drin+ed  on  the  ELF.  A  cooy 
of  the  CE  screen  is  also  printed  when  a  PLANIT  EEAD 
reouest  is  active  and  an  interrupt  able  switch  action 
has  been  taken. 

“urns  off  the  cooy  function  of  +he  ELP.  Cutout  directed 
to  either  screen  is  not  printed  nor  are  answers  returned 
to  PLANTT . 
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TABLE  A- 3 


SA  INDICATOR  COMMAND  LIST 


ON 

COMMAND 

OFF  COMMAND 

INDICATOR  NAME 

IS-ON 

IS— OFF 

ILL.  SW  ACTION 

CB-ON 

CB-OFF 

CMPTR  BUSY 

SV-ON 

SV-OFF 

SAVE 

PM-ON 

PM-OFF 

PRIORITY  MESSAGE 

Not 

applicable 

MA-OFF 

MESSAGE  ADDRESS  A 

MB-OFF 

MESSAGE  ADDRESS  B 

MC-OFF 

MESSAGE  ADDRESS  C 

\ 

/ 

MD-OFF 

MESSAGE  ADDRESS  D 

ME-OFF 

MESSAGE  ADDRESS  E 

CT- 

■ON 

CT-OFF 

C/E  D  TEST 

RT- 

•ON 

RT-OFF 

RD  TEST 

NOTE:  MATRIX  SWITCHES  CANNOT  BE  TURNED  ON  OR  OFF,  EXCEPT 

BY  OPERATOR  ACTION. 

MESSAGE  ADDRESS  SWITCHES  CANNOT  BE  TURNED  ON,  EXCEPT 


BY  OPERATOR  ACTION 


TABLE  A~U 


INTERRUPTABLE  SWITCH  ACTION  SA  READ  RESPONSES 


MNEMONIC 

SWITCH  NAME 

PR 

PRINT  on  C/E  D  keyboard 

XM 

XMIT  on  C/E  D  keyboard 

PM 

PRIORITY  MESSAGE 

CM 

CYCLE  MESSAGES 

PG 

PAGE 

RX 

RD  XMIT 

RA 

RD  CMPTR  ACTION 

DL 

DELETE 

TE 

TRANSFER  TO  EDIT 

CF 

CHECK  FIRING 

CC 

CANCEL  CHECK  FIRING 

FP 

FPF 

SP 

SPARE 

CA 

C/E  D  CMPTR  ACTION 

RP 

REPLACE 

sv 

SAVE 

RS 

RESTORE 

FC 

FORMAT  COMMAND 

FS 

FORMAT  SELECT 

IS 

ILL.  SW  ACTION 

RT 

RD  TEST 

CT 

C/E  D  TEST 

A-ll 


TABLE  A-5 


MATRIX  AND  MESSAGE  ADDRESS  SA  READ  RESPONSES 


MNEMONIC  SWITCH  NAME 


r-c  Row  and  column  matrix  selection,  "r"  will  be 

either  0  (no  row  selection)  or  the  letter  for  the 
row  selected  (A  thru  H).  "c"  will  be  either  0 

(no  column  selected)  or  the  number  for  the  column 
selected  (1  thru  8).  For  example: 

0-0  no  selection. 

0-2  no  row  selection,  column  2  selected. 

A-0  row  A,  no  column  selected. 

C-3  row  C,  column  3. 

MA  MESSAGE  ADDRESS  A 

MB  MESSAGE  ADDRESS  B 

MC  MESSAGE  ADDRESS  C 

MD  MESSAGE  ADDRESS  D 

ME  MESSAGE  ADDRESS  E 

NOTE:  Matrix  selections  are  mutually  exclusive  and 

only  one  matrix  mnemonic  will  be  returned. 


Message  Address  selections  are  not  mutually 
exclusive  and  up  to  five  mnemonics  will  be 
returned. 
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MNEMONIC  COMMANDS 
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BE 
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RETURNED 
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VFMST)/vTOr  MESSAGE  APPRrSS  PREAMBLES 
E-1.0  INTRODUCTION 
B-l .  1  Purpose  and  Scope 


Everv  message  transmitted  by  or  received  bv  a  YFMBT!  or  **107  has  a 
’Message  address  preamble,  "he  purpose  of  this  appendix  is  +o  describe 
the  format  of  the  preamble,  t.he  effect,  a  received  preamble  has  on  t.he 
♦erminal  and  the  preambles  venerated  by  the  terminal.  The  detail 
presented  is  intended  *o  give  a  PLANT"  author  a  basic  unders*anding 
of  the  terminal  communication  formats. 

B-l .2  Reference  Documents 

I'he  material  described  in  this  appendix  was  derrived  from  the  following 
documents : 

EL- Cr-OOOUl 1 07  3  CEI  SPECIFICATION  FOR  VARIABLE  *C*yiT  MESSAGE 
ENTRY  DEVICE  (VFMED) 

el-cf-?507-"0  prime  itf*  development  specification  fo° 

MESSAGE  INPU"  CUTPrr  TEVICE  (MIOP) 

FOR  T0S? 


B-l . 3  Terms 

"he  following  terms  are  defined  for  convenience  so  that  subseauent. 
reference  to  t.he  terms  will  not  require  confusing  explanation 
when  used i 

a,  VFMED  -  vChen  used  without  "old"  or  "new"  applies  to  either, 

b.  Gld  VF^ETJ  -  the  VF'^ju  hardware  associated  with  the  original 
and  Mod-8P  T ACFT-E  configurations. 

e.  New  VFMED  -  The  VF^SD  hardware  associated  with  the  TACFIRE  LP 
configuration.  It  consists  or  all  new  hardware,  the  hear* 
of  which  is  a  Remote  Data  "erminal  (RDT).  The  RU"  includes 
a  microprocessor,  expanded  control  oannel  and  is  more 
versatile  *han  the  original  VF*ED. 

d.  Terminal  Address  -  The  terminal  address  is  determined  by 
t.he  ELP  CHANNEL  SELECT  switch  for  the  old  VF*EP  or  *T0D 
and  is  one  of  0  numbers  n  thru  7.  "Tie  terminal  address  for 
a  new  VF*ED  is  determined  by  the  RDT  source  address  thumb¬ 
wheel  setting  and  may  be  set  to  any  character,  PLANIT 
operations  reouire  this  number  to  be  set  t.o  0  for  all 
terminals. 


r 


B-l .3  Terms  (continued) 

e.  Computer  Address  -  The  address  which  the  consumer  software 
will  accept  and/or  generate  for  messages.  The  letter  J  is 
used  for  PLANIT  operations.  The  new  VFMED  ROT  destination 
address  should  be  set  to  J  for  PLANIT  operations. 


B-2.0  MESSAGE  ADDRESS  PREAMBLE 

The  first  6  characters  of  evarv  message  transmitted  by  or  received  by 
a  VFVED  or  MIOD  are  a  message  address  preamble.  Figure  3-1  shows 
the  format  of  a  message  and  defines  the  characters  in  the  preamble. 


1 

IE 

IE 

ID 

IE 

1 

— 

1 

^——Message  Source  ASCII  E0T^ 

Authentication/ Serial  Index 

.  ransmission  repeat,  musoer 

FIGURE  3-1  Message  Format 


B-2,1  Message  Destination  Character 

The  first  character  of  the  preamble  is  the  message  destination  character, 
A  received  message  is  ignored  by  a  VFMED  or  MIOD  unless  the  destination 
character  matches  the  terminal  address. 

The  message  destination  character  of  a  composed  message  transmitted 
by  a  VFMED  or  ^ICD  is  determined  by  one  of  the  following  means* 

a.  Old  VFMED  or  MIOD  -  The  message  destination  character  is  the 
1st  character  of  the  transmitted  message. 

b.  New  VFMED  -  The  message  destination  character  is  the  thumb¬ 
wheel  selected  on  the  RDT  and  replaces  the  1st  character 

of  the  composed  message. 


When  a  message  is  directed  to  the  computer  the  message  destination 
character  should  be  the  letter  J  for  PLANIT  operations. 


5-2 . 2  Authentication  Characters 

The  2nd,  3rd  and  4th  characters  of  the  preamble  are  the  authentication 
characters.  These  characters  are  used  to  determine  the  authenticity  of 
a  message  in  a  tactical  operational  system.  PLANTT  operation  treats 
these  characters  as  normal  aloha -numeric  characters  and  places  no 
restriction  on  either  the  operator  or  lesson  author  as  to  their  content. 

B-2 . 3  Message  Type  Character 

The  5th  character  of  the  preamble  is  the  message  type  designation,  '.•.hen 
a  message  is  received  at  a  terminal,  this  character  determine  what 
happens  to  the  message  and  other  terminal  reactions  (see  B-3.0 ). 

For  composed  messages  transmitted  by  the  terminal  this  character  has 
significance  only  in  a  tactical  operational  system  (see  B-3.0).  For 
PLANIT  operation  the  character  may  be  any  alpha-numeric  character, 

5-2,4  Message  Source  Character 

""he  6th  character  of  the  preamble  is  the  message  source  character. 

For  messages  sent  by  the  computer  the  character  will  be  the  letter 
J.  The  message  source  character  of  a  composed  message  transmitted 
by  a  VFMZD  or  MICj  is  determined  by  one  of  the  following  means i 

a.  Old  VF^ED  or  MIOD  -  The  message  source  character  is  the 
6th  character  of  the  transmitted  message. 

b.  New  VF^D  -  The  message  source  character  is  the 
thumb-wheel  selected  HIT!*  source  address  and  replaces  the 
6th  character  of  the  composed  message. 

VJhen  a  message  is  composed  to  be  sent  to  the  computer  the  message 
source  character  should  be  the  number  0  for  PLANIT  operation. 


B-3.0  TERMINAL  REACTION  TO  RECEIVED  MESSAGE  TYP?  CHARACTERS 

The  5th  character  of  a  message  received  by  a  VFMED  or  MICD  terminal 
determins  what  happens  on  the  terminal.  The  VF*ED  and  MIOD  react  differently 
and  are  described  in  separate  sub-paragraohs. 

B-3,1  VFMED  Terminal  reactions 

Six  message  type  characters  are  defined  for  the  TACFIRE  VFMED.  The 
terminal  reaction  to  any  of  these  or  any  undefined  message  types 
ta  as  follows: 

a.  All  messages  (except  type  5)  including  the  preamble  will 
be  printed  on  the  ELP,  Type  5  messages  are  acknowledgment 
messages  received  from  the  computer. 


B-3 


3-3.1  VFC'ED  Terminal  factions  (cent  tnued ) 

b.  All  messages  (except  type  5)  will  be  written  on  the  DE 
screen,  from  the  original  cursor  position,  if  the 
COMPOSE  EDXr  switch  is  in  the  off  position, 

c.  If  the  message  ♦•yoe  was  L  (test)  then  an  ELP  self-test, 

will  be  oerformed.  This  causes  a  test  message 

to  be  orinted  following  the  original  message, 

d.  Indicators  on  the  ELF  are  illuminated  as  shown  in  Table  B-l. 


TABLE  B-l,  </F«ED  Message  Tyne  and  Indicator  Reaction 


MESSAGE 

TYPE 

MEANING 

INDIG 

ATOR  ACTION 

1 

Check  Firing 

Turns 

on 

CHECK  FIRING  indicator. 

2 

Fire  Mission 

Turns 

on 

FIRE  MISSION  indicator. 

3 

New  Message 

\ms 

on 

MESSAGE  indicator. 

k 

Test 

Turns 

on 

MESSAGE  indicator. 

5 

Acknowledge 

Does  not. 

affect  indicators. 

6 

Relay 

Aims 

on 

MESSAGE  indicator. 

other 

Undefined 

Aims 

on 

MESSAGE  indicator. 

B-3.2  MIOD  '"ermlnal  Reactions 

Message  tyoe  characters  received  by  the  MIOD  select  the  terminal 
reaction.  It  is  possible  to  selectively  output  a  message  to  the  DE 
screen  and/or  ELP  or  neither  and  turn  indicators  on  or  off  and 
sound  the  alarm.  Table  B-2  gives  the  MIOD  reactions  to  various 
message  tyoe  characters. 


B-L 


■"A3LF.  5-2.  VICO  Message  Tyo*  and  terminal  Reaction 


*  "his  message  is  an  acknowledgement  receiver?  from  the  computer. 
An  acknowledgement  is  not  returner?,  and  lights  and  alarms  are 
unaffected.  ith  all  other  message  arrivals,  lights  and  alarms 
are  turned  either  on  or  o^f. 


■  vv.  - 


B-iA.O  GENERATED  MESSAGES 


The  VEMED  and  MICD  both  generate  <3 -character  canned  messages  in  response 
to  received  messages  (auto-Ack)  and  in  resDonse  to  svitoh  activations 
on  the  terminal,  These  canned  messages  are  shown  in  Table  3-3  for 
the  VFMED  and  in  ’’able  3-L  for  the  ^TCD. 


TABLE  3-3,  VFVED  Generated  Messares 


SWITCH  ACTIVATED  MESSAGE  GENERATED  COMMENT 


none 


ACK 

SE-XKIT 


Auto-Ack  message,  generated 
after  any  message  received 
except  a  type  5. 

Manual- Ack  message. 

Manual-Nak  message. 


TABLE  9-&.  MIOD  Generated  Messages 


■SVITDH  ACTIVATED 


MESSAGE  GENERATED 


COMMENT 


none 

ACK 

RE-XMIT 

MESSAGE  REQUEST 


Auto-Ack  message,  generated 
after  any  message  received 
except  a  type  S, 

Manual-Aek  message. 

Manual-Nak  message. 

vess*ge  Request  message. 


